home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / match97e.zip / DRSYSOP.DOC < prev    next >
Text File  |  1990-01-28  |  45KB  |  1,255 lines
  1.  
  2.  
  3.  
  4.  
  5.                                    DR. MATCHER
  6.                      All-Purpose Matchmaker for RBBS Systems
  7.                                Sysop Documentation
  8.                                   RELEASE 0.97d
  9.                                     01/28/90
  10.  
  11.                          (C) 1988, 1989, 1990 Kevin Patz
  12.                                 Capital of NH BBS
  13.                                   (603)228-3820
  14.  
  15.              Dr. Matcher is an all-purpose questionnaire matching system
  16.         designed to be accessed as a "door" from RBBS-PC, version 15-1C
  17.         through 17-2B and beyond, or from single and multi-user versions
  18.         of Wildcat!, or PCBoard 14.0*.  Users who enter this door are
  19.         given a series of questions defined by the sysop.  The answers
  20.         are put on file for other users to match against.  The user can
  21.         then set his preferences; i.e., what the user is looking for in
  22.         his or her matches.  This makes Dr. Matcher very flexible by
  23.         allowing the user to find users that match his liking, even if it
  24.         is very different from what he is like.  Dr. Matcher then
  25.         compares his preferences against other users' questionnaires; the
  26.         percentages are calculated and the users listed, highest matches
  27.         first.  He can then view the matching questionnaire answers.
  28.  
  29.              Since the questions are completely sysop-defined, Dr.
  30.         Matcher can be used for an unlimited range of applications.  For
  31.         example, a BBS run by an employment agency may use Dr. Matcher to
  32.         match potential employers with employees.  A BBS may use Dr.
  33.         Matcher to allow users to learn more about one another or to
  34.         "match up" users with the same computer type, etc.  Then there's
  35.         computer dating.  The individual preferences with the "MUST
  36.         MATCH" feature is useful for dating applications.  A single man
  37.         may want only single women to be listed.  He would set up his
  38.         preferences so that "female" and "single" MUST MATCH or the
  39.         "match-ee" is not displayed.
  40.  
  41.              This .ZIP file or diskette contains the following files:
  42.  
  43.              DRINIT.EXE        (Dr. Matcher Initialization Program)
  44.              DRINSTR.DOC       (Dr. Matcher user instructions)
  45.              DRMATCH.EXE       (Dr. Matcher Program)
  46.              DR-OPEN.DOC       (Dr. Matcher opening messages)
  47.              DRQUEST.ASC       (Sample ASCII questionnaire)
  48.              DRSYSOP.DOC       (This documentation)
  49.              DRTO96.EXE        (Conversion program from 0.95 to 0.97d)
  50.  
  51.         * PCBoard 14.0 support is being provided "as-is" until fully
  52.         tested.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 1         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 1         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                Dr. Matcher License
  71.  
  72.              No, I'm not going into "legaleze".  I'm not going to say
  73.         "register your copy or I'll have your head removed."  I'm not
  74.         going to say anything is "strictly forbidden."  No shrink wrap.
  75.         No "crippled" demos.  You may take this copy of Dr. Matcher and
  76.         do what you like with it.  However, for the sake of sanity (for
  77.         both the sysops who use Dr. Matcher and me), I recommend that you
  78.         abide by the following guidelines:
  79.  
  80.              Distribute it with the original files intact.  It's ok to
  81.         "zoo" it or otherwise pack it into a form other than the PKZIP I
  82.         used, just as long as whoever downloads it ends up with the same
  83.         stuff I uploaded.
  84.  
  85.              Do not alter or remove any copyright messages in the
  86.         documentation or programs.
  87.  
  88.              Bear in mind that this is a beta version of the program and
  89.         that not all features may work properly.  For example, some of
  90.         the sysop functions aren't even implemented yet.  If you do find
  91.         bugs or ideas for enhancements, I'd like to know about them.  My
  92.         BBS number is at the top of this file, or you can reach me at the
  93.         following BBS's:
  94.  
  95.              Reno RBBS (702-746-1364, 702-746-1365)
  96.              Ken Goosens (703-978-6360)
  97.  
  98.              In the present stage, Dr. Matcher is compatible with RBBS-PC
  99.         15-1C and later, Wildcat!, and other BBSs that use a compatible
  100.         DORINFOx.DEF or CALLINFO.BBS file.  Support for other BBS's
  101.         (Opus, etc.) is planned in the future.  PCBoard 14.0 support has
  102.         been added, but is being beta tested and may not work properly in
  103.         this release.
  104.  
  105.              If you like Dr. Matcher, please register your copy.
  106.         Registering Dr. Matcher and other shareware packages makes it
  107.         possible for shareware authors to continue providing high quality
  108.         software at a reasonable cost.
  109.  
  110.              Three registration options are available:
  111.  
  112.              Registration only. . . . . . . . . . . . . . . . . . $20.00
  113.              Registration and diskette updates. . . . . . . . . . $25.00
  114.              Registration, diskette, and printed documentation. . $30.00
  115.  
  116.         Please make checks payable to Kevin J. Patz, and send to the
  117.         following address:
  118.  
  119.              Kevin J. Patz
  120.              1 Oak Street
  121.              Concord, NH  03301
  122.  
  123.  
  124.  
  125.  
  126.  
  127.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 2         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 2         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                             Capital Doorware Features
  137.  
  138.              Dr. Matcher is 100% home-grown.  No code was taken from
  139.         other door programs.  This allowed maximum flexibility in
  140.         designing the door interface and the program itself.  Several Dr.
  141.         Matcher features will be standard in any doors I write in the
  142.         future.
  143.  
  144.              * Sysop can Define the maximum number of users, answers and
  145.         preferences per question.  Each available answer or preference to
  146.         a question takes up disk space.  The space required increases as
  147.         the number of users increases.  The sysop can decide how much
  148.         space he is willing to set aside.
  149.  
  150.              * Data files can be fixed or variable length.  Fixed-length
  151.         files can hold a specified number of users, but will work in any
  152.         "shared" environment, such as LANs and multi-node BBS's.
  153.         Variable-length files "grow" in length as users enter the
  154.         database.  While this allows as many users as disk space allows,
  155.         some networks or multi-tasking operating systems may not support
  156.         this option.  Dr. Matcher supports either fixed or variable
  157.         length files.
  158.  
  159.              * Maximum session time in the door can be set by the sysop.
  160.         However, the time limit will never be greater than the time the
  161.         user has available in the BBS session.  The sysop can choose to
  162.         limit time only by the BBS time remaining.  The door program
  163.         will warn the user when his or her time is almost up.
  164.  
  165.              * The maximum idle time can be set by the sysop.  If a user
  166.         sits idle for too long, the door will exit back to the BBS.  A
  167.         thirty-second warning is given to get the user's attention before
  168.         exiting.
  169.  
  170.              * Any "beeps" sent to the user by the door will not be heard
  171.         locally by the sysop, allowing the sysop to sleep better at
  172.         night.
  173.  
  174.              * The door will, at the Sysop's option, drop DTR to the
  175.         modem if the carrier is dropped.  This feature is useful for BBS
  176.         systems where the modem answers the phone instead of the BBS.
  177.         With DTR dropped, the modem will not answer the phone until the
  178.         BBS is safely reloaded.
  179.  
  180.              * The DORINFOx.DEF or CALLINFO.BBS file written by the BBS
  181.         doesn't have to be in the current directory where Dr. Matcher
  182.         resides.  The sysop can specify a path to find the file,
  183.         eliminating the need to copy it to the door directory if the
  184.         sysop doesn't put the door in the BBS's current directory.
  185.  
  186.              * In addition to checking the user name to see if it matches
  187.         the sysop name, a minimum security level can be specified for
  188.         sysop access.  This feature is useful for BBS systems with co-
  189.         sysops, where the sysop may want other users to be able to access
  190.         the Dr. Matcher sysop functions.
  191.  
  192.  
  193.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 3         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 3         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.              * Minimum security level to access the door, as well as a
  204.         minimum security level for first-time access to the door, allow
  205.         access to be restricted for whatever reason.  Like RBBS
  206.         conferences, the door can be made public, private or semi-
  207.         private.
  208.  
  209.              * Individual override security levels can be specified.
  210.         This provides the ultimate in flexibility.  Up to ten individual
  211.         security levels can be granted access to the door, regardless of
  212.         the minimum security.  In addition, up to ten security levels can
  213.         be denied access to the door, regardless of the minimum security.
  214.         An example of where this might be used is if you wanted to set up
  215.         an "adults-only" Dr. Matcher questionnaire.  You could set up
  216.         your security levels as follows:  5 = normal user; 6 = adult
  217.         normal user; 7 = contributing user; 8 = adult contributing user;
  218.         9 = donating user; 10 = adult donating user, and so on.  You
  219.         would then set up the override security levels to grant access to
  220.         the door if you're at level 6, 8, or 10, and deny access to 5, 7,
  221.         and 9.  The Sysop is not restricted by security levels.
  222.  
  223.              * Support for RTS/CTS flow control is available, for users
  224.         of high-speed and/or error correcting modems.
  225.  
  226.              * A daily maintenance routine automatically deletes users
  227.         who have not accessed the door within the number of days
  228.         specified by the sysop.
  229.  
  230.              * User records can be added, changed, or deleted by the
  231.         sysop.  The sysop can lock out individual users if necessary.
  232.  
  233.              * "Hang-proof" error trapping code has been incorporated.
  234.         Even if a totally unexpected run-time error occurs, it is
  235.         reported to the user (if possible), logged to an error file, and
  236.         the program exits gracefully to the BBS, without waiting for a
  237.         local sysop to "strike a key to return to system."
  238.  
  239.              * The sysop can take the user into chat anytime while the
  240.         door is in operation.  In addition, an emergency key will bail
  241.         the door back out to DOS (and then to the BBS) in the event of a
  242.         hang or an abusive user.
  243.  
  244.              * Baud rates up to 19200 are supported.
  245.  
  246.              * Sysop can include him or herself in the questionnaire with
  247.         the option to remain anonymous (use the name "Sysop").
  248.  
  249.              * Access to the user editor is limited to those with sysop
  250.         access; in addition a password can be specified which the user
  251.         must enter in order to access the editor.
  252.  
  253.              * Either BASIC communication I/O routines or a FOSSIL driver
  254.         can be used for modem communication.  The BASIC routines don't
  255.         require any special drivers, but support only COM1 and COM2.
  256.         By installing a FOSSIL driver, Dr. Matcher can access COM1-COM8
  257.  
  258.  
  259.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 4         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 4         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.         with no special action required short of installing and
  269.         configuring the FOSSIL driver, and telling Dr. Matcher to use it.
  270.  
  271.              * Users with ANSI color support can access Dr. Matcher in
  272.         color.  The sysop has the option of suppressing colors on the
  273.         local display, which is helpful for sysops with monochrome
  274.         displays.  No longer does the sysop have to squint to read a full
  275.         screen of underlined text if a user chooses to use "blue"
  276.         text.
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 5         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 5         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 5
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                 THE QUESTIONNAIRE
  335.  
  336.              The questionnaire is initially defined in an ASCII file.  A
  337.         sample questionnaire called DRQUEST.ASC is included in the
  338.         archive.  This file is read by DRINIT to produce DRQUEST.DR, the
  339.         questionnaire file formatted for use with Dr. Matcher.  The
  340.         format for the questionnaire is as follows:
  341.  
  342.         ?question1 prefix
  343.         # (max number of answers to this question)
  344.         answer1
  345.         answer2
  346.         ?question2 prefix
  347.         # (max number of answers to this question)
  348.         answer1
  349.         answer2
  350.  
  351.              The question prefix is prefaced by a question mark (?) and
  352.         consists of the beginning part of the question.  For example, if
  353.         the question regards eye color, the prefix would be "?My eyes
  354.         are".  The user's answers are appended to this prefix when
  355.         viewing the questionnaires.
  356.  
  357.              The max # of answers to this question is a numeric value (1
  358.         or greater) which specifies the maximum number of answers that
  359.         will be accepted for this question.  For example, for sex (male
  360.         or female), you'll want to allow only one answer since nobody is
  361.         both male and female.  For eye color, you'll probably want to
  362.         allow two for mixed colors.  For hobbies, you'll want to allow
  363.         more answers.
  364.  
  365.              Answer1, answer2, etc.  are the answer choices for the
  366.         question.  A sample question format follows:
  367.  
  368.              ?I drive a
  369.              2
  370.              car
  371.              truck
  372.              bus
  373.              van
  374.  
  375.         The maximum number of answers that can be given to this question
  376.         are 2, and there are four choices to choose from:  car, truck,
  377.         bus, or van.  When viewing, "I drive a" is followed by the
  378.         choices given; for example, "I drive a truck."
  379.  
  380.              Blank lines can be inserted anywhere in the ASCII
  381.         questionnaire file as they are ignored by DRINIT.  Comment lines
  382.         start with a semicolon (;); these are ignored by DRINIT.
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 6         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 6         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 6
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                      DRINIT
  401.  
  402.              DRINIT, the Dr. Matcher initialization program, loads the
  403.         initial questionnaire and setup information for your Dr. Matcher.
  404.         This program should be run only once, when you first set up the
  405.         program.
  406.  
  407.              DRINIT will ask you a series of questions regarding the
  408.         desired configuration of Dr. Matcher.  The questions, and
  409.         explanations, are given below.
  410.  
  411. Enter the name of the ASCII file containing the questionnaire to be loaded.
  412. Default:  DRQUEST.ASC:
  413.  
  414.              DRINIT is asking for the name of your ASCII questionnaire
  415.         file, as defined above.  Specifying no file name tells DRINIT to
  416.         use DRQUEST.ASC.  DRQUEST.ASC, which is included with Dr.
  417.         Matcher, is an all-purpose file which is good to start with.
  418.         This file is read to produce the Dr. Matcher questionnaire file
  419.         DRQUEST.DR.
  420.  
  421. What's the maximum number of answers a user can give per question?
  422.  
  423.              Dr. Matcher needs to assign file space for each answer a
  424.         user gives to a question.  Therefore, the sysop needs to define
  425.         the maximum number of answers a user can give per question.  The
  426.         recommended amount is the largest number of answers that can be
  427.         given to any question defined in the questionnaire file.  For
  428.         example, if one question in your questionnaire allows 8 answers,
  429.         you should set this value to 8.  There is a maximum of 26 answers
  430.         per question (A-Z).
  431.  
  432. What's the maximum number of preferred answers a user can give per question
  433. (when matchmaking)?  Each takes up 23 bytes of disk space per user.
  434.  
  435.              Preferred answers, or preferences, are the answers to the
  436.         questionnaire that a user wants to see matched against.  When a
  437.         user invokes the matchmaker, his or her preferences are matched
  438.         against the other users' questionnaire answers.  This provides
  439.         great flexibility since the user's own questionnaire answers
  440.         (which should reflect him or herself) don't have to be what he or
  441.         she matches to (which may be completely different).  I recommend
  442.         allowing as many preferences as disk space will allow, but not
  443.         more than the largest number of choices for a question in the
  444.         questionnaire.
  445.  
  446. What's the maximum number of users who can access Dr. Matcher and save their
  447. questionnaire results and preferences?
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 7         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 7         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 7
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.              The amount of disk space required per user is shown.  This
  467.         value defines the maximum number of users that can be in the Dr.
  468.         Matcher file at one time.  Unless disk space is tight, I
  469.         recommend as many as your BBS system will handle.  If a user
  470.         enters Dr. Matcher and there is no room for his or her
  471.         questionnaire, the user can access Dr. Matcher as a "guest",
  472.         provided that questionnaires are not required (see below).
  473.  
  474.              In Dr. Matcher 0.96 and up, you can specify zero (0) as the
  475.         maximum number of users.  If this is done, the user and
  476.         questionnaire/preference files will be initialized to a length of
  477.         zero, and the files grow as users are added.  The number of users
  478.         is limited only by available disk space.  However, some
  479.         multitasking or network environments don't handle extending files
  480.         properly.  If you have a multi-node BBS and user records are
  481.         being lost or garbled, try switching to fixed-length.
  482.  
  483. What's the maximum number of minutes allowed per session?  0 indicates
  484. to limit time only by time available in the BBS session.
  485.  
  486.              Dr. Matcher allows you to set a session time limit in
  487.         addition to BBS's built in time limits.  If you specify a time
  488.         limit here, a user can remain in Dr. Matcher no longer than the
  489.         specified number of minutes, even if BBS allows more time.  If
  490.         you specify 0, then the only time limit will be the time
  491.         remaining on the BBS.
  492.  
  493. What's the maximum number of minutes that a user can be idle?
  494.  
  495.              If a user stays idle (doesn't respond to a prompt) for more
  496.         than the specified number of minutes (I recommend 3 or whatever
  497.         you use for maximum idle time on the BBS), Dr. Matcher will exit
  498.         back to the BBS.  A thirty second warning will be given
  499.         beforehand.
  500.  
  501. Drop DTR if carrier lost (Y,[N])? y
  502.  
  503.              This feature is useful for sysops who are "shooting
  504.         themselves in the foot" by setting RBBS to answer on zero rings.
  505.         If this option is set to Y, Dr. Matcher will force DTR low when
  506.         carrier is lost, so the modem won't answer the phone until RBBS
  507.         or Wildcat! is safely reloaded.  However, some modems (such as
  508.         the US Robotics Sportster 2400PC) may malfunction when this
  509.         option is used.
  510.  
  511. 0) RBBS-PC
  512. 1) Wildcat!
  513. Select BBS type:
  514.  
  515.              If you're running Wildcat!, answer 1.  If you're running
  516.         RBBS-PC 15-1C or later or another BBS which uses the DORINFOx.DEF
  517.         file, answer 0.
  518.  
  519. Enter the drive and/or path where DORINFOx.DEF can be found when Dr. Matcher
  520. is started.
  521.  
  522.  
  523.  Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 8 Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 8 Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 8
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.              DORINFOx.DEF is created in the current directory where RBBS-
  534.         PC resides.  Specifying the path here eliminates the need to copy
  535.         DORINFOx.DEF to your Dr. Matcher subdirectory in your door batch
  536.         file.  Enter the drive and path only, not the filename.  The
  537.         fully qualified pathname will be displayed for confirmation.  If
  538.         you don't enter a drive, the default drive will be used.  If you
  539.         don't specify a path, the current directory will be used.
  540.  
  541.              For Wildcat! users the file is CALLINFO.BBS instead of
  542.         DORINFOx.DEF, and for PCBoard users it is PCBOARD.SYS and USERS.
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 9         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 9         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 9
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. Enter the password that the Sysop must enter to access the editor.
  599.  
  600.              For security reasons, when a remote (not local) sysop uses
  601.         the D command to access the editor, a password is required.  Here
  602.         you can set this password.  It must be at least four characters,
  603.         and upper and lower case are treated the same.  DRINIT will allow
  604.         you to confirm and correct the password before proceeding.
  605.  
  606. Should password be required to access editor locally (Y,[N])?
  607.  
  608.              If you want to make it necessary to enter the editor
  609.         password when logged on locally, answer Y.  Answering N will make
  610.         it unnecessary to enter the password when logged onto the BBS
  611.         locally.
  612.  
  613. Enter minimum security level to access Sysop functions.
  614.  
  615.              This option allows you to specify a minimum security level
  616.         for access to Sysop functions (D-editor and L-list log).  Note
  617.         that this security level applies only to users other than the
  618.         main sysop.  The main sysop has full sysop access regardless of
  619.         the security level.  This level allows you to grant Dr. Matcher
  620.         sysop access to other users based on security level.  If you want
  621.         no other users to have sysop access, set this level to a very
  622.         high value (32767).
  623.  
  624. Enter the minimum security level required to access Dr. Matcher:
  625.  
  626.              Dr. Matcher's access can be restricted by security level.
  627.         This level is the minimum required for any user to access Dr.
  628.         Matcher.  Note that the Individual Override Security Levels
  629.         explained below have precedence over this minimum security.
  630.  
  631. Enter the minimum security for new users to access Dr. Matcher:
  632.  
  633.              This is the minimum security level for new users (users not
  634.         in the Dr. Matcher user file) to join (be auto-added) to Dr.
  635.         Matcher.  By setting these levels appropriately, Dr. Matcher can
  636.         be open (available to all), semi-private (available only to users
  637.         with a minimum security), or closed (available only to users
  638.         specifically added to the user file by the sysop).
  639.  
  640. You can specify up to ten security levels which will be allowed access
  641. to Dr. Matcher regardless of the minimum security.  To specify less than
  642. ten, leave the remainder blank.  To specify none, leave all blank (or zero).
  643.  
  644.              INDIVIDUAL OVERRIDE SECURITY LEVELS add a new dimension of
  645.         flexibility to access control of Dr. Matcher and future CNHBBS
  646.         doors.  Up to ten individual (not minimum) security levels can be
  647.         specified that will be GRANTED or DENIED access to Dr. Matcher,
  648.         regardless of the minimum security level.  This feature would be
  649.         useful for sysops who want to set up an "adults only" Dr. Matcher
  650.         questionnaire.  Alternate security levels could be defined for
  651.         adults and non-adults on the BBS.  Only the adult levels would be
  652.         granted access to Dr. Matcher, yet the levels in the BBS could be
  653.  
  654.  
  655.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 10         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 10         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 10
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.         arranged so that you can have a hierarchy of levels (new user,
  665.         registered user, contributing user, sysop, etc.)
  666.  
  667.              This prompt lets you specify up to ten security levels that
  668.         will be granted access to Dr. Matcher.  You'll be prompted ten
  669.         times for security levels.  If you have less than ten (or none),
  670.         simply press Enter through the remaining prompts.
  671.  
  672.              The next prompt works the same way, but lets you specify up
  673.         to ten security levels that will be denied access to Dr. Matcher.
  674.  
  675. Does your modem use RTS/CTS for flow control (Y,[N])?
  676.  
  677.              If you use an error-correcting modem, a high speed modem
  678.         (over 2400 bps), a setup where the phone line rate is different
  679.         from the rate between the modem and the computer, or any other
  680.         situation where hardware flow control is needed, answer Y to this
  681.         prompt.  Software (XON/XOFF) flow control is supported regardless
  682.         of the answer to this prompt.
  683.  
  684. Will users be required to fill out the questionnaire (Y,[N])?
  685.  
  686.              If you answer N to this prompt, users can access the
  687.         matchmaker function without filling out their questionnaires
  688.         (only preferences are needed for matchmaking).  However, the
  689.         sysop may feel that too few users are filling out their
  690.         questionnaires, making for few matches.  If this is the case,
  691.         answering Y to this prompt will require users to have an active
  692.         questionnaire in order to invoke the matchmaker.  In addition,
  693.         the Toggle Questionnaire on/off (T command) will be unavailable
  694.         to users, unless the Sysop hides the user's questionnaire, in
  695.         which case the user can unhide it with the T command.  In
  696.         addition, users will be denied access if the users file is full,
  697.         since such users cannot file a questionnaire.
  698.  
  699. How many lines for a user profile (0 for none)?
  700.  
  701.              If you specify a number (n) of lines here, users will be
  702.         able to file comments about themselves along with their
  703.         questionnaire (up to n 72-character lines); this information can
  704.         be viewed while matchmaking.  If you specify 0, then users will
  705.         not be able to enter or view profiles.  **THIS IS NOT IMPLEMENTED
  706.         IN 0.97d**
  707.  
  708. How many days before deleting an inactive user?
  709.  
  710.              Dr. Matcher runs an automatic maintenance routine when the
  711.         first user accesses it on a given day.  This routine deletes any
  712.         users who haven't logged onto Dr. Matcher within the number of
  713.         days specified here.  This keeps the file uncluttered with users
  714.         who "try it once" and never access it again.  Up to 365 days can
  715.         be specified.
  716.  
  717. Should Sysop remain anonymous (Y,[N])?
  718.  
  719.  
  720.  
  721.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 11         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 11         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 11
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.              If you answer N (default) to this question, the sysop's
  731.         questionnaire will be filed under his or her real name as defined
  732.         in the RBBS-PC configuration.  If you answer Y, the sysop's
  733.         questionnaire will have the name "Sysop."
  734.  
  735.              The following three questions appear only for Wildcat! and
  736.         PCBoard users, since the door can get this information from RBBS.
  737.  
  738. Enter the name of your Wildcat! (or PCBoard) BBS:
  739.  
  740.              Enter the name of your BBS here.  Dr. Matcher uses this in
  741.         the sign-on screen and when exiting ("Returning to _____....").
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 12         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 12         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 12
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. Enter Sysop's First name:
  797. Enter Sysop's Last name:
  798.  
  799.              Enter the main BBS sysop's name here.  Dr. Matcher uses this
  800.         to determine if the user is the sysop and grants appropriate
  801.         privileges.  In addition, this name is shown when the sysop
  802.         enters chat mode ("Hi, I'm ______ and we're in chat mode.").
  803.  
  804. Use FOSSIL calls (Y,[N])?
  805.  
  806.              If you answer Y, Dr. Matcher will use FOSSIL calls for
  807.         communications in Wildcat! mode.  In RBBS mode, FOSSIL will be
  808.         used if RBBS is using FOSSIL.  If you answer N, FOSSIL will not
  809.         be used at all.  RBBS users should answer Y to this question
  810.         since then Dr. Matcher will determine from the DORINFOx.DEF
  811.         whether to use FOSSIL or not.
  812.  
  813.                                  DRMATCH.DR File
  814.  
  815.              The file DRMATCH.DR is a file containing the configuration
  816.         information generated by DRINIT.  If you wish to change this
  817.         configuration information without rerunning DRINIT, the following
  818.         is a sample file with the records explained.  It is an ASCII
  819.         sequential file, which can be edited by any text editor that
  820.         writes ASCII files.
  821.  
  822.  70     <-----------------  Line  1: DO NOT CHANGE!  (Max users)
  823.  23     <-----------------  Line  2: DO NOT CHANGE!  (# questions)
  824.  8      <-----------------  Line  3: DO NOT CHANGE!  (Max answers)
  825.  10     <-----------------  Line  4: DO NOT CHANGE!  (Max preferences)
  826.  3      <-----------------  Line  5: Maximum idle minutes
  827. -1      <-----------------  Line  6: -1=Drop DTR on carrier loss, 0=no
  828.  30     <-----------------  Line  7: Maximum minutes per session
  829. C:\TEST\ <----------------  Line  8: Path of DORINFOx.DEF (no filename)
  830. 0,0,0,0,0,0,0,0,0,0 <-----  Line  9: Individual access security levels
  831. 0,0,0,0,0,0,0,0,0,0 <-----  Line 10: Individual deny security levels
  832.  10     <-----------------  Line 11: Minimum security for Sysop functions
  833. PASSWORD  <---------------  Line 12: Sysop editor password
  834.  5      <-----------------  Line 13: Minimum security for normal access
  835.  5      <-----------------  Line 14: Minimum security for new users
  836.  0      <-----------------  Line 15: -1=use RTS/CTS, 0=don't use
  837.  0      <-----------------  Line 16: -1=require filled out questionnaire
  838.  30     <-----------------  Line 17: Days before inactive user deleted
  839.  0      <-----------------  Line 18: -1=sysop anonymous, 0=not anonymous
  840.  0      <-----------------  Line 19: 0=RBBS-PC, 1=Wildcat!, 2=PCBoard
  841.  1      <-----------------  Line 20: Color Support                 ****
  842.  0      <-----------------  Line 21: -1=Use FOSSIL                 ****
  843.  0      <-----------------  Line 22: Number of Lines in PROFILE    ****
  844.  0      <-----------------  Line 23: Require password in LOCAL     ****
  845. My BBS  <----------------- *Line 24: Name of bulletin board
  846. Joe     <----------------- *Line 25: Sysop's first name
  847. Sysop   <----------------- *Line 26: Sysop's last name
  848.  
  849. ****  New fields in 0.96+
  850. * Wildcat! only
  851.  
  852.  
  853.  Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 13 Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 13 Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 13
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.              DO NOT CHANGE LINES 1-4!!  These records contain important
  864.         information needed to properly read the user and
  865.         answer/preference files.
  866.  
  867.              Lines 24-26 are only used in Wildcat! and PCBoard modes.  In
  868.         RBBS mode, this information comes from DORINFOx.DEF.
  869.  
  870.  
  871.                                  SYSOP FUNCTIONS
  872.  
  873.              In addition to all normal Dr. Matcher functions (which are
  874.         explained in the file DRINSTR.DOC which is readable on-line),
  875.         there are two commands that can be accessed only by the sysop.
  876.  
  877.              L - List Activity Log
  878.  
  879.              The L command at the main Dr. Matcher prompt will list all
  880.         activity that has occurred in Dr. Matcher.  The sysop also has
  881.         the option to delete this file after reading it.
  882.  
  883.              D - Sysop Editor
  884.  
  885.              The D command at the main Dr. Matcher prompt will access the
  886.         Dr. Matcher editor.  If you're accessing remotely (or as a non-
  887.         RBBS user in local mode using the /L option), you'll be asked for
  888.         the editor password.  There are four options in the editor:
  889.  
  890.         Edit (U)sers, (R)eload questionnaire, [Q]uit?
  891.  
  892.              NOTICE:  Only (U)ser and [Q]uit are available in beta 0.97d.
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 14         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 14         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 14
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.              Quit simply restarts Dr. Matcher.  User allows the sysop to
  929.         edit the Dr. Matcher user file.  The following is a sample
  930.         session:
  931.  
  932. Edit (U)sers, (R)eload questionnaire, [Q]uit? u
  933. User name or search string ([Enter] quits)? kevin
  934. KEVIN PATZ (Y,[N])? y
  935. (A) Name: Kevin Patz
  936.     Days since last on:  0
  937. (B) User allowed to enter Dr. Matcher: YES
  938. (C) User's questionnaire is active: YES
  939. (D) Clear User's Questionnaire
  940. (E) Clear User's Preferences
  941. (F) DELETE this user
  942. [Q] Quit editing this user
  943.  
  944. User command (?,A,B,C,D,E,F,[Q])?
  945.  
  946.              The "User name or search string" prompt allows the sysop to
  947.         enter a full or partial name to search on.  Any matches are shown
  948.         with a "yes/no" prompt.  If the specified user name is not found,
  949.         the sysop is given the option to add the user to the file.  This
  950.         add capability is useful for special purposes or for giving users
  951.         access to a closed Dr. Matcher.
  952.  
  953.              Option A allows the sysop to change the user's name.  Days
  954.         since last on cannot be changed in this version.
  955.  
  956.              Option B allows the sysop to lock a user out of Dr. Matcher,
  957.         or to unlock a locked user.  Note that the sysop can lock himself
  958.         out of Dr. Matcher.  If this happens, the sysop cannot access the
  959.         standard matchmaker functions, but can still access the Editor
  960.         and the Activity Log.
  961.  
  962.              Option C allows the sysop to hide or unhide a user's
  963.         questionnaire.  This option works like the "(T)oggle
  964.         questionnaire on/off" option at the main prompt, except that the
  965.         sysop can hide and unhide questionnaires even if the users are
  966.         required to have a questionnaire to access the matcher.  A hidden
  967.         questionnaire is not included in a matchmaking operation.  Hiding
  968.         a questionnaire may be useful if a user goes on vacation and
  969.         doesn't want users matching him or her and leaving large
  970.         quantities of messages on the BBS.
  971.  
  972.              Option D allows the sysop to erase a user's answers to the
  973.         questionnaire.
  974.  
  975.              Option E allows the sysop to erase a user's preferences.
  976.  
  977.              Option F allows the sysop to completely erase a user from
  978.         Dr. Matcher's user file, making room for another user.
  979.  
  980.              Option Q quits editing the user so another user can be
  981.         edited or the sysop can quit from there.
  982.  
  983.  
  984.  
  985.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 15         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 15         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 15
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.                          DR. MATCHER SYSOP FUNCTION KEYS
  995.  
  996.              Dr. Matcher uses the following function keys:
  997.  
  998.              <F1> will immediately force Dr. Matcher to exit back to DOS.
  999.         From here the door batch file will return control to the BBS if
  1000.         run as a door or live program.  If run from the DOS prompt, <F1>
  1001.         will exit back to DOS.
  1002.  
  1003.              <F2> will cause Dr. Matcher to exit to a DOS Shell.  This
  1004.         allows the sysop to temporarily suspend the Dr. Matcher session
  1005.         to execute DOS commands.  After exiting from the shell (by typing
  1006.         EXIT at the DOS prompt), Dr. Matcher resumes at the point of
  1007.         interruption.  Note that COMMAND.COM must be available in the
  1008.         path specified by the environment variable COMSPEC.  If you
  1009.         boot from a hard drive, this should be the case.
  1010.  
  1011.              <F10> allows the sysop to enter chat mode with the user
  1012.         currently in Dr. Matcher.  This key works the same way as <F10>
  1013.         in RBBS.  When in chat, the user and sysop can type messages back
  1014.         and forth to each other.  When the sysop presses <Esc>, chat mode
  1015.         ends and the user returns to the point where he or she was before
  1016.         chat mode was entered.
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 16         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 16         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 16
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                        SAMPLE DR. MATCHER DOOR BATCH FILE
  1061.  
  1062.              Dr. Matcher, once configured, is installed into the RBBS
  1063.         door system like any other door.  No door monitor is needed.
  1064.         Create a batch file (e.g. MATCH.BAT) and insert MATCH (and a
  1065.         description) into your MENU5 or equivalent.
  1066.  
  1067.              If you're using Wildcat!, see the Wildcat! documentation for
  1068.         instructions on creating a batch file for live programs.
  1069.  
  1070.              Since Dr. Matcher's init program lets you specify a path to
  1071.         DORINFOx.DEF, there's no need to copy DORINFOx.DEF if you have
  1072.         Dr. Matcher in a different directory from RBBS.  Here's a sample
  1073.         batch file for invoking Dr. Matcher from a RBBS running in
  1074.         C:\RBBS with Dr. Matcher in C:\MATCH (comments in parentheses
  1075.         must not be entered into the batch file)
  1076.  
  1077. watchdg1 off        (Dr. Matcher checks carrier; no watchdog needed)
  1078. cd\match            (change to Dr. Matcher subdirectory)
  1079. drmatch %1          (Invoke Dr. Matcher and pass node number)
  1080. cd\rbbs             (Return to RBBS subdirectory)
  1081.  
  1082.                            DR. MATCHER COMMAND SYNTAX
  1083.  
  1084.              The following describes the command-line syntax and options
  1085.         to invoke Dr. Matcher.  Items in brackets [] are optional.
  1086.  
  1087.              [drive][path]DRMATCH [node] [/C] [/D] [/L] [/N]
  1088.  
  1089.              [drive] and [path] are the drive and path where the file
  1090.         DRMATCH.EXE resides.  This is not necessary if Dr. Matcher is in
  1091.         the current directory or PATH.
  1092.  
  1093.              [node] is the RBBS node number.  If omitted, node 1 is
  1094.         assumed.  This parameter is not used in Wildcat! mode.  In RBBS
  1095.         mode, it specifies which DORINFOx.DEF file to read.
  1096.  
  1097.              /C tells Dr. Matcher to ignore the CD (Carrier Detect)
  1098.         signal on the serial port.  This may be useful when testing or
  1099.         running Dr. Matcher with a computer or terminal connected
  1100.         directly to the BBS's serial port.  Without this option, Dr.
  1101.         Matcher terminates if CD is dropped (when the caller disconnects
  1102.         while in Dr. Matcher).
  1103.  
  1104.              /D activates Debugging mode.  Use this option if you get a
  1105.         "Fatal error" message or a mysterious hang.  /D defeats the
  1106.         "Hang-proof Error Handling" and causes a normal BASIC error
  1107.         termination to occur when an untrapped error occurs.  This way
  1108.         you'll get an English error message instead of an error code,
  1109.         though the system will freeze until you strike a key to continue.
  1110.  
  1111.              /L activates Local mode.  In this mode DORINFOx.DEF or
  1112.         CALLINFO.BBS is not read, no modem communication takes place, and
  1113.         the door runs as if it were a stand-alone program.  This is
  1114.         useful for testing or setting up Dr. Matcher without using a
  1115.  
  1116.  
  1117.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 17         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 17         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 17
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.         modem.  When /L is specified, you'll be prompted for your first
  1127.         and last names since it can't get them from a BBS in this mode.
  1128.  
  1129.              /N (Wildcat! mode only) tells Dr. Matcher to use the
  1130.         caller's baud rate instead of the port baud rate in CALLINFO.BBS.
  1131.         This option shouldn't be necessary unless a compatibility problem
  1132.         arises.
  1133.  
  1134.                                    TROUBLES??
  1135.  
  1136.              Fatal Errors??  If you get a fatal error when invoking Dr.
  1137.         Matcher, the most likely cause is a missing file.  Check that the
  1138.         following files are available in the current directory when Dr.
  1139.         Matcher is invoked:
  1140.  
  1141.              DRMATCH.DR      (Configuration file created by DRINIT)
  1142.              DRQUEST.DR      (Questionnaire file created by DRINIT)
  1143.              DRANSWER.DR     (Answer/preference file created by DRINIT)
  1144.              DRUSERS.DR      (User file created by DRINIT)
  1145.              DORINFOx.DEF    (Created by RBBS - make sure it's available
  1146.         in the drive/directory you specified when running DRINIT- x is
  1147.         the node number)
  1148.              CALLINFO.BBS    (Created by Wildcat! - see DORINFOx.DEF
  1149.         above)
  1150.  
  1151.         Other Files Used:
  1152.  
  1153.              DRPRELOG.DOC      (Pre-log messages - displayed first-optional)
  1154.              DAY.DR            (Last day Dr. Matcher was accessed-created
  1155.         by Dr. Matcher)
  1156.              DR-OPEN.DOC       (Dr. Matcher opening messages - optional)
  1157.              DRINSTR.DOC       (Dr. Matcher user instructions)
  1158.              DRMATCH.LOG       (Activity Log created by Dr. Matcher)
  1159.              ERRORS.DR         (Fatal Error log, created by Dr. Matcher)
  1160.  
  1161.              Fatal errors are logged in ERRORS.DR in the current
  1162.         directory.  The error number is a BASIC error code.  If you have
  1163.         a GW-BASIC (tm) or QuickBASIC (tm) manual, you can look up the
  1164.         error code and find out what the error is.  Error 53 is caused by
  1165.         missing files.  Error 62 is caused by an incomplete file.  If you
  1166.         get this error after upgrading from an earlier version of Dr.
  1167.         Matcher, check your DRMATCH.DR file (see the section above on
  1168.         this file).  New fields may have been added.
  1169.  
  1170.              If you have modem troubles, check your handshaking.  You may
  1171.         need to turn RTS/CTS on or off.  Edit DRMATCH.DR as explained
  1172.         above or rerun DRINIT.  If Dr. Matcher, for whatever reason,
  1173.         decides that there is no carrier when there is, try invoking Dr.
  1174.         Matcher with the /c option:  DRMATCH /C %1.
  1175.  
  1176.              If you find a problem which you believe is a bug, please let
  1177.         me know.  If you can reproduce the problem, leave a message on my
  1178.         BBS describing how you caused it to fail.  If you could upload a
  1179.         capture file of the bug in action that would help too.
  1180.  
  1181.  
  1182.  
  1183.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 18         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 18         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 18
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.              If you as Sysop (running Dr. Matcher locally) find a bug
  1193.         that you can reproduce, run Dr. Matcher locally outside of RBBS
  1194.         with output redirection as follows:
  1195.  
  1196.              drmatch /l >filename
  1197.  
  1198.              This will direct the screen output to a file that you can
  1199.         then upload to my BBS (603-228-3820).
  1200.  
  1201.              * GW-BASIC and QuickBASIC are trademarks of Microsoft Corp.
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.          Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 19         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 19         Dr. Matcher 0.97d      (C) 1990 K. Patz             Page 19
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.